Use GitHub Markdown as Knowledge Source of Truth
Use GitHub Markdown as Knowledge Source of Truth
Decision
개인/에이전트 지식관리 시스템의 원장은 GitHub 기반 Markdown 저장소로 둔다.
Context
Hermes, Claude Code, OpenCode 등 여러 에이전트가 같은 지식 체계를 읽고 갱신해야 한다. 또한 사용자는 Obsidian graph view로 개념 간 연결을 파악하고 싶다.
Alternatives Considered
- Notion 중심 PKM
- Obsidian-only vault
- Vector DB first architecture
- Graph DB first architecture
- 개별 에이전트의 세션/메모리에만 의존
Rationale
GitHub Markdown은 사람이 읽기 쉽고, 에이전트가 수정하기 쉬우며, diff/review/rollback/branch/PR/commit history를 제공한다. Obsidian은 같은 Markdown 파일을 탐색 UI로 사용할 수 있고, RAG/vector DB는 나중에 Markdown 원장에서 재생성 가능한 derived artifact로 붙일 수 있다.
Consequences
- 모든 장기 지식은 Markdown + YAML frontmatter로 표현한다.
- 에이전트는
AGENTS.md규칙을 따라야 한다. - Obsidian wikilink를 사용해 개념 관계를 유지한다.
- RAG/vector index는 source of truth가 아니다.
- 지식 변경은 Git commit 단위로 추적한다.